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Preface 





Intended Audience 


This manual is intended for VMS system managers, operators, and system 
programmers. 





Document Structure 
This document consists of the following three sections: 


e Description—Provides a full description of the Bad Block Locator Utility 
(BAD). 
e Usage Summary—Outlines the following BAD information: 
-Invoking the utility 
—Exiting from the utility 
—Directing output 
—Restrictions or privileges required 


¢ Qualifiers—Describes BAD qualifiers, including format, parameters, and 
examples. 





Associated Documents 


For additional information on the topics covered in this document, see the 
VMS DCL Dictionary and the Guide to Maintaining a VMS System. Also see 
the VMS System Messages and Recovery Procedures Reference Manual for 
explanations of diagnostic messages and suggestions for user action. 
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Conventions 
| Convention 


RET 


CTRL/C 


$ SHOW TIME 
O5-JUN-1988 11:55:22 


$ TYPE MYFILE.DAT 


input-file, ... 


[logical-name] 


quotation marks 
apostrophes 


viii 


Meaning 


In examples, a key name (usually abbreviated) 
shown within a box indicates that you press 

a key on the keyboard; in text, a key name is 
not enclosed in a box. In this example, the key 
is the RETURN key. (Note that the RETURN 
key is not usually shown in syntax statements 
or in all examples; however, assume that you 
must press the RETURN key after entering a 
command or responding to a prompt.) 


A key combination, shown in uppercase with a 
slash separating two key names, indicates that 
you hold down the first key while you press the 
second key. For example, the key combination 
CTRL/C indicates that you hold down the key 
labeled CTRL while you press the key labeled C. 
In examples, a key combination is enclosed in a 
box. 


In examples, system output (what the system 
displays) is shown in black. User input (what 
you enter) is shown in red. 


In examples, a vertical series of periods, or 
ellipsis, means either that not all the data that 
the system would display in response to a 
command is shown or that not all the data a 
user would enter is shown. 


In examples, a horizontal ellipsis indicates 
that additional parameters, values, or other 
information can be entered, that preceding 
items can be repeated one or more times, or 
that optional arguments in a statement have 
been omitted. 


Brackets indicate that the enclosed item is 
optional. (Brackets are not, however, optional 
in the syntax of a directory name in a file 
specification or in the syntax of a substring 
specification in an assignment statement.) 


The term quotation marks is used to refer 
to double quotation marks (“). The term 
apostrophe (‘) is used to refer to a single 
quotation mark. 


New and Changed Features 


There are no technical changes to the Bad Block Locator Utility (BAD) for VMS Version 5.0. 


BAD BLOCK LOCATOR Description 


The Bad Block Locator Utility (BAD) locates bad blocks on a volume by 
testing whether data that is written onto blocks can be read back. When 
it finds a bad block, BAD writes the address of that block to the Software 
Detected Bad Block File (SDBBF). 


To invoke BAD, enter the DCL command ANALYZE/MEDIA. To ensure that 
the device is not accessed by any other programs, you must first allocate the 
device with the DCL command ALLOCATE. 


After you allocate the device, enter the DCL command MOUNT/FOREIGN. 
When the device is mounted foreign, the system does not recognize it as a 
Files-11 volume and BAD can execute. Table BAD-1 describes the devices 
that BAD can analyze. 


To test the blocks on a volume, BAD does the following: 
e Writes a test pattern to each block on the medium 
e Reads the contents of the block into a buffer 


¢ Compares the data read back with the data written 


If the data does not compare exactly, a block cannot reliably store data. 


When you run BAD to test a device (using the /EXERCISE qualifier), keep in 
mind the following: 


e The device cannot be accessed by other programs. 
e The device cannot be mounted as a Files-11 volume. 


e The device is always purged by BAD’s testing procedure; any information 
stored on the disk is destroyed. 


Caution: There is no way to test the volume for bad blocks without destroying its 
contents. However, you can update the Detected Bad Block File (DBBF) 
without erasing the volume’s contents by using the BAD qualifiers 
/NOEXERCISE and /BAD_BLOCKS. 





Recording Bad Blocks 


When BAD locates a bad block, it records the address of the block. 
Consecutive bad blocks are recorded as single entries for non-last-track 
devices. After it finishes testing the disk, BAD writes the addresses of the bad 
blocks into an area called the Detected Bad Block File (DBBF). 


After BAD locates and records the bad blocks, enter the DCL command 
INITIALIZE to change the volume from unstructured format to Files-11 
format and to allocate the faulty blocks to a special file on the volume 
called [(OOO0000|BADBLK.SYS. In this way, users are protected from accessing 
bad blocks for their files. For more information on Files-11 format and the 
INITIALIZE command, see the VMS DCL Dictionary. 
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BAD BLOCK LOCATOR Description 


1.1 Location of the Detected Bad Block File 


The location of the DBBF depends on whether the volume is a last-track 
device, that is, one that contains more than 4096 blocks (512 bytes per block). 
Last-track devices store bad block data on the last track of the disk. 


The first half of the track is reserved for the Manufacturer’s Detected Bad 
Block File (MDBBF). The MDBBEF stores the bad blocks discovered by the 
manufacturer when the device was originally formatted. 


The second half of the track is reserved for the Software Detected Bad Block 
File (SDBBF). 


Non-last-track devices are devices that contain 4096 blocks (512 bytes per 
block) or less. These devices do not set aside the last track of the disk to store 
bad block information. Instead, BAD creates the DBBF on the last good block 
of the disk. There must be at least one reliable block in the last 256 blocks of 
the volume for BAD to generate the DBBF. 


1.2 Format of the Detected Bad Block File 
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If the volume is a last-track device, each DBBF entry contains the cylinder, 
track, and sector address of the faulty block. 


On volumes that are not last track, DBBF entries contain the number of bad 
blocks minus 1, and the logical block number (LBN) of the faulty block or 
sequence of faulty blocks. A single entry can address one bad block or several 
contiguous bad blocks. 


The DBBF can contain a maximum of 126 entries. For both last-track and 
non-last-track devices, BAD terminates with an error message when the 
maximum number of entries is exceeded. However, the contents of the 
SDBBF on the medium remains intact. 


Running BAD on Devices Converted to Non-Last- Track Format 


If you run BAD in compatibility mode using the override (/OVR) qualifier 
on a device designated as last-track, the medium on the device is converted 
to non-last-track format. When you run BAD in native mode on such a 
device, BAD treats it as a last-track device and fails to find the Manufacturer’s 
Detected Bad Sector File (MDBSF). Depending on which qualifiers you specify 
with the ANALYZE/MEDIA command, you can expect the following results 
when running BAD on a converted device: 


e If you do not attempt to modify the medium on the device (for example, 
if you specify /NOEXERCISE /OUTPUT), BAD, upon failing to locate the 
MDBSF, attempts to find the Software Detected Bad Sector File (SDBSF) 
and produces an output listing using the non-last-track format. 


e If you attempt to modify the medium preserving the SDBSF (for example, 
if you specify /EXERCISE=KEEP or /NOEXERCISE /BAD_BLOCKS), 
BAD terminates with the following fatal diagnostic message: 


7, BAD-F-MDBSFRFAIL, Failed to read the manufacturer’s detected bad 
sector file on DEVICENAME 


BAD BLOCK LOCATOR Description 


Note that all attempts to preserve the SDBSF when modifying the medium 
on a converted device will fail. However, if you do not attempt to preserve 
the SDBSF (for example, by specifying /EXERCISE=KEEP), BAD recreates 
the MDBSF and SDBSF and continues testing. You could use the following 
command sequence to run BAD on a converted device, in this case DB1: 


$ ANALYZE/MEDIA/OUTPUT=DBiTEST.ANL DB1: 

ANALYZE/MEDIA 15-APR-1988 08:16:53.97 PAGE 1 
DB1: (DBAi:), SERIAL NUMBER: 0 

SOFTWARE DETECTED BAD BLOCKS 


LOGICAL BLOCK NUMBER COUNT 
88308 0 


DEVICE DBA1:CONTAINS A TOTAL OF 340670 BLOCKS; 1 DEFECTIVE BLOCK DETECTED 
ANALYZE/MEDIA/EXERCISE/OUTPUT=DB1TEST.ANL DB1: 





Running BAD Interactively from Your Terminal 


When you run BAD interactively from your terminal, use a sequence of 
commands similar to the following: 


$ ALLOCATE DBA2: 

DBA2: ALLOCATED 

$ MOUNT/FOREIGN DBAQ2: 

%MOUNT- I-MOUNTED mounted on DBA2: 
$ ANALYZE/MEDIA/EXERCISE DBA2: 

$ INITIALIZE DBA2: 


The ALLOCATE command requests the allocation of a specific disk drive, 
DBA2. The response from the ALLOCATE command indicates that the device 
was successfully allocated. The MOUNT/FOREIGN command mounts the 
disk volume as a foreign disk. The MOUNT command response indicates that 
DBA2 was successfully mounted. The ANALYZE/MEDIA command invokes 
BAD. Specifying DBA2 and the /EXERCISE qualifier causes BAD to analyze 
each block on this disk volume and to record the bad blocks. The INITIALIZE 
command reformats the volume as a Files-11 volume and allocates the bad 
blocks to a file on the volume called [O00000/|BADBLK.SYS. Once allocated, 
the bad blocks cannot be used by other files. 





Running BAD from a Command Procedure 


You can invoke BAD from a VMS command procedure. The following 
command procedure, NEWDISK.COM, invokes BAD and allocates, mounts, 
dismounts, and initializes the volume: 
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BAD BLOCK LOCATOR Description 


$! THIS COMMAND PROCEDURE EXERCISES AND INITIALIZES THE 
$! SPECIFIED DISK. 

$! 

$! P1 IS THE DEVICE 

$! P2 IS THE VOLUME LABEL 


$! 

$! 

$ IF P1 .EQS. "" THEN $ INQUIRE P1 "DEVICE TO BE INITIALIZED" 
$ IF P2 .EQS. "" THEN $ INQUIRE P2 "VOLUME LABEL" 


$ ALLOCATE ’P1 

$ MOUNT/FOREIGN ’P1 

$ ANALYZE/MEDIA/EXERCISE ’P1 
$ DISMOUNT/NOUNLOAD ’P1 

$ INITIALIZE ’P1 ’P2 

$ EXIT 


To run this command procedure, type the following command in response to 
the DCL prompt: 


@NEWDISK device volume-label 





Table of Block-Addressable Devices 
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Note: 


Table BAD-1 includes the following information for each device that BAD 
can analyze: 


e Device model name 

e Device code 

e Device type 

e Revolutions per minute 

e Block-addressable surfaces per medium 
e¢ Cylinders per medium 

e Bytes per track 


e¢ Total bytes per medium 


You do not need to run BAD on Mass Storage Control Protocol (MSCP) 
devices (for example, RX50 diskettes, and RA60, RA80, and RA81 disk 
drives). All MSCP devices appear to the operating system as a contiguous 
stream of logical blocks. If part of the disk goes bad, the drive itself 
revectors the bad block automatically. 


Table BAD-1 
Model Code 
RBO2 Da 
RLO2 DL 
RMO3  ~=DR 
RMO5 ~ ~=ODR 
RB80 DQ 
RM80 _ ~=—ODR 
RPO5 DB 
RPO6 DB 
RPO7 DR 
RKO6 DM 
RKO7 DM 
RX01 DX 
RXO2. DX 
TU58* DD 
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Block-Addressable Devices 


Type 


Cart 
Cart 
Pack 
Pack 
Fix 
Fix 
Pack 
Pack 
Fix 
Cart 
Cart 
Flop 
Flop 


Cart 


RPM 


2400 
2400 
3600 
3600 
3600 
3600 
3600 
3600 
3600 
2400 
2400 

360 

360 


Surfaces 


2 
2 
5 
19 
14 
14 
19 


Cylinders 


512 
512 
823 
823 
559 
559 
411 
815 
630 
411 
815 

77 

77 


'The RPO7 has 16 surfaces but 32 tracks per cylinder. 
2The RXO2 single-density diskette. 
3The RXO2 double-density diskette. 


10,240 
10,240 
16,384 
16,384 
15,872 
15,872 
11,264 
11,264 


25,600 


11,264 

11,264 
3,328 
33287 
6,656° 


“The TU58 is a magnetic tape device that operationally resembles a disk device. 


Device Types 


Pack-——disk pack 


Cart—disk cartridge 
Flop—flexible diskette 


Fix—fixed disk 


Bytes/TrackBytes/Medium 


10,485,760 
10,485,760 
67,420,160 
256,196,608 
124,124,272 
124,124,272 
87,960,576 
174,423,040 
5 16,096,000 
13,888,512 
27,540,480 
256,256 
256,256 
512,512 
262,144 
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BAD BLOCK LOCATOR Usage Summary 


The Bad Block Locator Utility (BAD) analyzes block-addressable devices 
and records the locations of blocks that cannot store data reliably. 





FORMAT — ANALYZE/MEDIA device 





PARAMETER device 


Specifies the device containing the volume that BAD will analyze. The device 
name has the form ddcu: or logical-name. 


usage summary To invoke BAD, enter the command ANALYZE/MEDIA at the DCL prompt 
along with any parameters or qualifiers. Once invoked, BAD runs until 
completion. When BAD terminates, control is returned to the DCL command 
level. 


To write the contents of the Detected Bad Block File (DBBF) to an output file, 
specify the /OUTPUT qualifier, as described in the following section. 


BAD-6 


BAD BLOCK LOCATOR 
BAD BLOCK LOCATOR Qualifiers 





BAD BLOCK This section presents qualifiers for the ANALYZE/MEDIA command in 
LOCATOR alphabetical order. The qualifiers follow the standard rules of DCL syntax. 
QUALIFIERS Thus, you can abbreviate any qualifier or keyword as long as the abbreviation 


is not ambiguous. The asterisk and the percent sign can be used as wildcard 
characters unless otherwise noted. 
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BAD BLOCK LOCATOR 
/BAD_BLOCKS 


/BAD_BLOCKS 


Adds the specified bad blocks to the Detected Bad Block File (DBBF). If the 
/BAD_BLOCKS qualifier is specified along with the /EXERCISE qualifier, 
the medium is tested and the bad blocks are added to the DBBF. 





FORMAT 


/BAD_BLOCKS [(-list)] 





KEYWORD 


BAD-8 


Note: 


list 
Specifies codes for the bad block locations to be added to the DBBF. 


If you do not specify a value for the /BAD_BLOCKS qualifier, BAD prompts 
as follows: 


BAD_BLOCKS = 


When it prompts, BAD reports any duplicate bad blocks. To terminate the 
prompting session, type CTRL/Z. 


The term block denotes a standard unit of 512 bytes, whereas the term 
“sector” denotes the physical size of the device sector, which is not 
always the same for all devices. For example, an RLO2 has a sector size of 
256 bytes, while an RKO7 has a standard sector size of 512 bytes. 


Valid bad block location codes follow. You can specify them in any integer 
combination or radix combination. 


Code Meaning 

lbn Specifies the logical block number (LBN) of a single 
bad block. 

lbn:count Specifies a range of contiguous bad blocks starting 


at the logical block number (LBN) and continuing 
for “count” blocks. 


sec.trk.cyl Specifies the physical disk address (sector, track, 
and cylinder) of a single bad sector. This code is 
valid only for last-track devices. 


sec.trk.cyl:count Specifies a range of bad sectors starting at the 
specified physical disk address (sector, track, and 
cylinder) and continuing for “count” sectors. This 
code is valid only for last-track devices. 


BAD BLOCK LOCATOR 
/BAD_BLOCKS 





EXAMPLES 


Gf] = $ ANALYZE/MEDIA/BAD_BLOCKS=(4.4.4:3) DB1: 


The /BAD_BLOCKS qualifier in this example specifies a range of 3 bad 
sectors beginning at the physical disk address sector 4, track 4, cylinder 4. 
This range is added to the DBBF. 


2 $ ANALYZE/MEDIA/EXERCISE/BAD_BLOCKS=(2) DB1: 


The command in this example adds the bad block specification to the DBBF 
and then tests the medium. The bad block in this example is located at logical 
block number (LBN) 2. 


3 $ ANALYZE/MEDIA/EXERCISE/BAD_BLOCKS DB1: 
BAD_BLOCKS = 2:3 
BAD_BLOCKS = 4 
% BAD-I-DUPBLKNUM, duplicate block number 4, already exists in SDBBF 
-BAD-I-SRCLIN, the source input entry was 4 
BAD_BLOCKS = 


BAD_BLOCKS= |CTRL/Z 


In this example, BAD prompts for bad block specifications. Note that, in 
prompt mode, BAD reports any duplicate bad blocks it detects. 
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BAD BLOCK LOCATOR 
/EXERCISE 


/EXERCISE 


Controls whether the medium should actually be tested. The default is 





/NOEXERCISE. 
FORMAT /EXERCISE [-(keywordf,...])/ 
/NOEXERCISE 





KEYWORDS FULL 


Causes BAD to test the medium using three test patterns (0’s, 1’s, and “worst 
case”) instead of the default single “worst case” pattern. The FULL keyword 
can be used only with /EXERCISE. Note that the “worst case” pattern always 
remains on media tested with the /EXERCISE qualifier. 


KEEP 


Ensures the preservation of the current SDBBF. The KEEP keyword is the 
default when /NOEXERCISE is specified. 


NOKEEP 

Causes BAD to create a new SDBBF. The NOKEEP keyword is the default 
when /EXERCISE is specified. This keyword cannot be used with the 
/NOEXERCISE qualifier. 


PATTERN=(longword{,...]) 


Allows users to specify the value of a test pattern to be used as “worst case.” 
Up to an octaword of test pattern data may be specified in decimal (%D), 
hexadecimal (%X), or octal (%O) radixes. The default radix is decimal. 


The pattern is specified in longwords. If two or more longwords are specified, 
they must be enclosed in parentheses and separated by commas. 





EXAMPLES 
f]  $ ANALYZE/MEDIA/EXERCISE=FULL DB1: 


The command in this example tests the medium using three test patterns. By 
default, a new SDBBF is created. 


P]  $ ANALYZE/MEDIA/EXERCISE=KEEP DB1: 


The command in this example tests the medium while preserving the current 
SDBBE. 


kK} $ ANALYZE/MEDIA/EXERCISE=PATTERN=(%XFFEEFFEE,%XBADBADBA) DB1: 


The command in this example specifies a hexadecimal test pattern two 
longwords in length. 
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BAD BLOCK LOCATOR 
/EXERCISE 


4 $ ANALYZE/MEDIA/NOEXERCISE/BAD_BLOCKS DB1: 


The command in this example updates the DBBF without erasing the volume’s 
contents. 
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BAD BLOCK LOCATOR 
/LOG 


/LOG 


Specifies whether a message is sent to SYS$OUTPUT and to SYS$ERROR 
indicating the total number of bad blocks detected by BAD. The default is 
/NOLOG. 





FORMAT /[NO]LOG 





EXAMPLE 


$ ANALYZE/MEDIA /LOG DBBi: 
Device DBB1i: contains a total of 340670 blocks; i1 defective blocks detected. 


The command in this example requests BAD to report the total number of 
bad blocks it detected on the device DBB1. 


BAD-12 


/OUTPUT 


BAD BLOCK LOCATOR 
/OUTPUT 


Specifies whether the contents of the DBBF are written to the specified 
file. If you omit the /OUTPUT qualifier, no output is generated. 


When you specify /OUTPUT in conjunction with the /SHOW qualifier, the 
default keyword for the /SHOW qualifier is AFTER. 











FORMAT /OUTPUT =/file-spec] 

KEYWORD file-spec 
Identifies the output file for storing the results of the medium analysis. If you 
specify a file type and omit the file name, the default file name ANALYZE is 
used. The default file type is ANL. If you omit the file-spec, the results are 
output to SYS$6OUTPUT. 
In place of the file-spec, you may specify an output device. In this case, BAD 
writes the contents of the volume’s DBBF to a file called ANALYZE.ANL and 
queues the file to the output device. 
No wildcard characters are allowed in the file specification. 

EXAMPLES 


f] = $ ANALYZE/MEDIA/OUTPUT=BADDBBF .DAT DBA2: 


The command in this example writes the contents of the DBBF from DBA2 
to the output file BADDBBF.DAT. Note that because /NOEXERCISE is the 
default, the medium is not tested. 


(= $ ANALYZE/MEDIA/OUTPUT=LPBO: DBA2: 


The command in this example writes the contents of the DBBF from DBA2 to 
the default file ANALYZE.ANL and queues the file to the print device LPBO. 
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BAD BLOCK LOCATOR 
/RETRY | 


/RETRY 


Enables the device driver to retry soft errors. The /RETRY qualifier is 
used only in conjunction with the /EXERCISE qualifier. The default is 
/NORETRY. 





FORMAT /EXERCISE /NORETRY 
/EXERCISE /RETRY 





EXAMPLE 
$ ANALYZE/MEDIA /EXERCISE /RETRY DBAO: 


The command in this example directs the device driver to retry soft errors. 
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BAD BLOCK LOCATOR 
/SHOW 


/SHOW 


Lists the contents of the DBBF before and after the medium is exercised 
(tested). 





FORMAT /SHOW [=(keyword,...])] 


KEYWORDS [NO]JBEFORE,[NOJAFTER 


Specifies whether the contents of the DBBF is listed before, after, or before 
and after the medium is exercised (tested). AFTER is the default. 








EXAMPLES 

1 $ ANALYZE/MEDIA/EXERCISE/OUTPUT/SHOW=(BEFORE,AFTER) DBAS: 
The command in this example lists the contents of the DBBF both before 
and after the disk DBA3 is exercised and directs the data to the current 
SYS$SOUTPUT device. 


h] = $ ANALYZE/MEDIA/EXERCISE/OUTPUT/SHOW DBA3: 


The command in this example lists the contents of the DBBF only after the 
disk DBA3 is exercised and directs the data to SYS$OUTPUT. 
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